Draws a size box.

OSStatus DrawThemeStandaloneGrowBox (
    Point origin, 
    ThemeGrowDirection growDirection, 
    Boolean isSmall, 
    ThemeDrawState state
);

origin

A structure of type Point. Pass the origin point of the size box rectangle. For example, the origin point of the size box for an object that can grow downward and to the right is the size box’s upper-left corner. Typically, you use the coordinates of the corner of whatever object owns the size box for the origin value. For example, if you are drawing a scrolling list that can grow downward and to the right, the origin value would be the coordinates of the bottom-right corner of the list.

growDirection

A value of type ThemeGrowDirection. Pass a constant specifying the direction(s) in which the resizeable object can grow. See “Theme Size Box Direction Constants” for descriptions of possible values. The Appearance Manager uses the growDirection parameter to establish which corner of the size box is the origin.

isSmall

A value of type Boolean. Pass a value of true to specify a small size box (typically for use with small scroll bars) or false to specify a standard size box.

state

A value of type ThemeDrawState. Pass a constant—either kThemeStateActive or kThemeStateInactive—appropriate to the current state of the size box; the size box cannot be drawn as pressed. See “Theme Draw State Constants” for descriptions of these values.

function result

A result code.

DISCUSSION

The DrawThemeStandaloneGrowBox function draws a theme-compliant size box that is suitable for use inside the content area of a window. The image is designed to fit between scroll bars and does not have to be abutted with the window frame.

Also see the function DrawThemeStandaloneNoGrowBox.

VERSION NOTES

This function is available with Appearance Manager 1.1 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)